18. Netwerken 
Niet voor de ESP32-C3, wel de andere ESP’s 


De controllers van Espressif hebben hard- en software aan boord voor de verbinding 
met een netwerk. De hardware is een WiFi module, de software zit in RTOS, het 
besturingssysteem dat elke ESP-controller heedft. RTOS bestuurt o.a. de 
netwerktoegang. De netwerkfuncties van MicroPython zijn een de verbinding tussen 
onze programma’s en de netwerkfuncties van RTOS. Een voordeel van de dubbel- 
core ESP's is dat één processor zich aan het netwerk kan wijden, de andere processor 
voert onze programma’s uit. De Raspberry Pi Pico W heeft een WiFi module aan 
boord, die doet al het werk voor de netwerktoegang. 


In de bijlage is een paragraaf gewijd aan de basisbeginselen van een TCP/IP netwerk. 


De verbinding met het netwerk 


We kunnen een ESP controller op twee manieren met een netwerk verbinden: 


e _ Als station: de controller maakt verbinding met een router of access-point 


e _ Als access-point: andere toestellen maken verbinding met de controller 


Verbinding met een router/access-point 

De figuur hieronder toont een typisch huisnetwerk: De router vormt de verbinding 
tussen het lokale huisnetwerk met Internet. De router zorgt ook voor de juiste 
netwerkinstellingen van de aangesloten toestellen. De toestellen op het netwerk zijn 
verbonden met de router via een netwerkkabel of draadloos. Een draadloos netwerk 
heeft een naam, de ssid. Meestal is dit netwerk beveiligd met een paswoord. 


Figuur 105: een typisch huisnetwerk 


Module network heeft de nodige methodes voor de netwerktoegang: 


e _network.WLAN(network.STA_IF) creëert een WLAN object voor 
verbinding met de router 


-139- 


e _active({True) en active(False) activeren of de-activeren de 
netwerkinterface 

e _activel) geeft de toestand van de interface 

e connect (ssid, password) maakt verbinding met het draadloos netwerk. 
De DHCP-serv er van de router levert automatisch de IP-parameters aan 
de controller. 

e _isconnected() geeft aan of we verbonden zijn 


e _ifconfig() geeft de IP-parameters van de verbinding. 


De verbinding met connect lukt niet altijd direct. Meestal moeten we enkele keren 
proberen. In het voorbeeld maken we verbinding met netwerk “WLAN-dirk” met 
paswoord “1234” 


Weespersnrrsrrsererrsnsssssnn # 
# wifi-sta.py # 
H # 
# 16 januari 2022 # 
WooscnrsrsrsenrsserssrsssnsTTen # 


import network, time 

essid = "WLAN-dirk” 

passwd = "1234" 

netSTA = network.WLAN(network.STA_IF) 

netSTA.active( True) 

while not netSTA. isconnected(): 
netSTA.active( True) 
netSTA.connect(essid, passwd) 
print(“connecting to ", essid) 
time.sleep(0.2) 

print(netSTA. ifconfig()) 


Het resultaat is ('192.168.1.47', '255.255.255.0', '192.168.1.1', '192.168.1.1'), het 
IP-adres van de module, het subnet-mask, het adres van de router en van de DNS- 
server. We kunnen dit controleren met opdracht ping op de PC vanaf de opdracht 
prompt. 


EN Opdrachtprompt a mf XxX 


Figuur 106: opdracht ping 


Zelf IP-parameters indgeven kan ook, we gebruiken methode ifconfig: 
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netSTA.ifconfig(('192.168.1.57', '255.255.255.0', '192.168.1.1', '192.168.1.1')) let 
op, we gebruiken dubbele haken. 


Opmerking: 

Het is geen goed idee om jouw netwerkgegevens zichtbaar in een programma op te 
nemen. Vroeg of laat ga je jouw programma’s doorgeven of publiceren. Niet 
iedereen moet toegang krijgen tot jouw persoonlijk WiFi netwerk. We maken 
daarom een bestand secrets.py aan met jouw geheime gegevens. Dat bestand 
kopiëren we naar de controller. Gebruikers van jouw programma gebruiken hun 
eigen versie van secrets.py. De bestanden worden dan: 


Herren ennen ennen # 
# secrets.py # 
H # 
# 2 augustus 2022 # 
Herren enen # 
secrets = { 

'ssid' : 'WLAN-dirk', 

‘pw’ : '1234' 
} 
Herren eneen # 
# wifi-sta.py # 
H # 
# 2 augustus 2022 # 


import network, time 

from secrets import secrets 

essid = secrets['ssid'] 

passwd = secrets['pw'] 

netSTA = network.WLAN(network.STA_IF) 

netSTA.active( True) 

while not netSTA.isconnected(): 
netSTA.active( True) 
netSTA.connect(essid, passwd) 
print(“connecting to ", essid) 
time.sleep(@.2) 

print (netSTA. ifconfig() ) 


Netwerktoepassingen 

De toepassingen in een netwerk zijn server-client gebaseerd: een client stuurt een 
vraag naar de server en de server stuurt een antwoord. Server en cliënt gebruiken 
dezelfde netwerkpoort en hetzelfde protocol (UDP of TCP). Zie ook de bijlage. Voor 
deze verbinding gebruiken we klasse socket van module socket. Enkele methodes 
hiervan zijn: 


e _addr = socket.getaddrinfo(server, poort) geeft adresinfo van de server. 
Server kan je opgeven met zijn url-adres (“www.google.be”) of zijn IP- 


nummer. 
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e _s=socket.socket() maakt een socket object 

e _connect() maakt een TCP-verbinding met de server 
e _send() stuurt een bericht over het netwerk 

e _rcv()leest een bericht uit het netwerk 


Gegevens van een webserver vragen 
Een webserver gebruikt poort 80 en een TCP-verbinding. TCP is een betrouwbaar 
protocol, met foutdetectie en connectie. In het voorbeeld lezen we 1000 bytes uit 


webserver www.google.be. 


e Het programma gebruikt ook secrets.py, die bevat de ssid en paswoord 
van jouw WiFi netwerk. 

e Heteerste deel van het programma is de configuratie van WiFi op de 
controller uit vorig voorbeeld. 

e Het resultaat van getaddrinfo is een tuple waar we één element van nodig 
hebben: element [O][-1] 

e Send stuurt een GET naar de server. Hiermee wordt informatie gevraagd 
in HTTP-vorm. Dat is webserver-jargon. 

e _Recv(1000) leest de eerste 1000 tekens van het antwoord in. 


Het resultaat is een stuk webpagina, geschreven in HTML-taal. In de bijlage gaan 
we daar iets meer van bekijken. 
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>>> %Run -c SEDITOR CONTENT 
('192.168.1.57', '255.255.255.0', '192.168.1.1', '192.168.1.1') 


('142.250.179.163', 80) 
b'HTTP/1.1 200 OK\r\nDate: Mon, 17 Jan 2022 14:07:08 GMT\r\nExpires: -1\r\nCache-Control: private, max- 


age=0\r\nContent-Type: text/html; charset=150-8859-1\r\nP3P: CP="This is not a P3P policy! See g.co/p3p 
help for more info."\r\nServer: gws\r\nX-XSS-Protection: O\r\nX-Frame-Options: SAMEORIGIN\r\nSet-Cookie 
2 NID=511=KROg86bOhiN8MMpaVwV1ld4sfgnu 8-c8HegrCEOtV7IMIMpzTMCTRzL7 sA--BsuXQCsZ3m-VN1MihxkpEybjbvXctUwD8 
UASaYKhNV66ptuWGxXNNeJktZFjOkQWXesBhPvn6 Edsq7alVLspCV-etpg6Kl8Ug8m2DNQxFak3ro; expires=Tue, 19-Jul-202 


2 14:07:08 GMT; path=/; domain=.google.be' 


>>> 


Figuur 107: webclient 


Een webserver 
Het programma hieronder is een heel eenvoudige webserver. 
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e Het eerste deel maakt de verbinding met het WiFi netwerk, analoog aan 
vorig voorbeeld. 

e Het tweede deel definieert een socket met poort 80, de webserver poort. 
Het stuk in de while True lus gaat na of er een aanvraag is van een webclient 
en stuurt de webpagina terug. 

e De opdracht print(netSTA.ifconfig()) toont het IP-adres van de server. Dat 
geven we in de browser van de PC in. Handiger is een vast IP-adres voor de 
server, gebruik daarvoor instructie netSTA.ifconfig(), zie hierboven. 

e String pagina bevat een stuk HTML code, dat wordt de webpagina. Hierin 
staat een titel, boodschap ‘Hello” en een link naar Google.be. 


0 [om Welmielt (el + me 
< _ A Nietbeveiligd | 192.168.1.47 s GG OO o 
G Google PJ RPI PI nanopi PI atiny8s Google Contacts 5 


MicroPython webserver 


Hello world 


zoeken op Internet 


Figuur 108: eenvoudige webserver 


Toepassing: GPIO’s uitlezen met de Webserver 

De webserver stuurt een pagina door met HTML-code. Daar kan je alle soorten 
gegevens inzetten zoals de toestand van een poort, de waarde van een sensor enz. 
Het voorbeeld hieronder leest een temperatuursensor uit en toont het resultaat op 
de webpagina. 


We meten de temperatuur een DS18B20-sensor aan GPIO4. Het eerste deel van het 
programma is afgeleid uit het programma voor deze sensor uit hoofdstuk Sensoren. 
De webpagina bestaat uit een stuk HTML-code. Daar is variabele tempe in 
opgenomen, de uitlezing van de sensor. De rest van het programma is identiek aan 
de webserver uit vorig voorbeeld. Helaas, deze configuratie drukt symbool ° voor 
voor de weergave van de temperatuur niet goed af, vandaar de ongewone notatie 
21.0 Celsius. 
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© (mu SWB © x Bl + Ps 
- ÁÀ Niet beveiligd | 192.168.1.47 Ys it © “) 
G Google FJ RPI EJ nanopi FJ attiny85 Google Contacts > 


Webserver-temperatuur 


Temperatuur: 21.0 Celcius 


Figuur 109: uitlezen temperatuur met webserver 


Toepassing: schakelen met een webserver 
In het voorbeeld gaan we met de webserver een LED aan of uitschakelen. 


© (SWL Ie « Bl + a ES 
| € A Nietbeveligd | 1921684147. % GO -o 
| G Google PJ RPL ET nanopi FJ attinys5 } Google Contacts > 


‚MicroPython webserver 
Remote web based control 
| LED aan 


| LED uit 


Figuur 110: schakelen met een webserver 


String pagina, een string van 7 regels, is de webpagina. Hierin zie je 2 hyperlink. Led 
aan verwijst naar http://192.168.1.47/led=aan, dat is hetzelfde adres 
met een stukje “/led=aan” De server geeft dezelfde pagina terug. We 
gaan na of dat stukje voorkomt in request, de aanvraagstring van de 
client. Indien ja, laten we de LED branden. 
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opmerking: 


In het voorbeeld is de LED aangesloten tussen GND en GPIO2, hij brandt als die 
waarde 0 heeft. 


Het adres van de server staat 2 maal in string pagina. Pas dat aan, jouw server heeft 
waarschijnlijk een ander adres. 
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Toepassing: een internetklok 

In hoofdstuk Timers en klokken hebben we gezien dat de tijd wordt bijgehouden als 
de epoch, het aantal seconden sinds 1 januari 1970, 0:00:00, UTC. Deze tijd is de tijd 
in Greenwich. Embedded systemen, zoals de controllers voor MicroPython 
gebruiken een epoch vanaf 1 januari 2000. Hieruit berekenen we de tijd in uren, 
minuten, … 


Op Internet zijn er NTP-servers (Network Time Protocol) die de de tijd uitzenden. We 
kunnen die gebruiken om de RTC van ons systeem te synchroniseren. De NTP- 
organisatrie raadt aan om hiervoor server www.ntppool.org te gebruiken. Als we die 
uitlezen met programma webclient van hierboven krijgen we volgend resultaat: 


Shell 
>>> 
>>> 


("192:168.1-47";, "255,255-255.0", '192,168.1.1', "TI2-168-N.1") 

('151.101.38.137', 80) 

b'HTTP/1.1 301 Moved Permanently\r\nServer: Varnish\r\nRetry-After: O\r\nLocation: https: //v 
rg/\r\nContent-Length: O\r\nAccept-Ranges: bytes\r\nDate: Wed, 19 Jan 2022 14:42: G r\ 
rnish\r\nConnection: close\r\nX-Served-By: cache-ams21034-AMS\r\nX-Cache: HIT\r\nX-Cache-Hits: 
imer: S1642603326.210979, VS0, VEO\r\nStrict-Transport-Security: max-age=12096000\r\n\r\n' 


>>> v 


Figuur 111: uitlezing van een ntp-server 


Datum en tijd kan je direct aflezen: woensdag 19 januari 2022, 14:42:06. Deze tijd is 
Greenwich tijd, in West-Europa is het één uur later. De epoch, het aantal seconden, 
staat er ook in, dat vind je in het stuk Timer: S1642603326.210979,. De cijfers tussen 
S en punt hebben we nodig. We kunnen ze omzetten naar een normale tijd met 
functie 


time.localtime(1642603326) 
Het resultaat is 
(2052, 1, 19, 14, 42, 6, 4, 19), 


Dat is 19 januari 2052, 14:42:06. Let op, NTP telt vanaf 1970, de controller vanaf 
2000, we moeten er 30 jaar van aftrekken en één uur bijtellen om datum en tijd in 
België of Nederland terug te vinden. Tijdens de zomertijd tel je 2 uur bij. 


In het programma moeten we de epoch uit het antwoord van de ntp-server 
peuteren. Daarvoor gebruiken we functie index(): 


String.index(“woord”) 


geeft de plaats waar voor het eerst woord voorkomt in de string. 
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Daarna zoeken we vanaf die plaats naar een opeenvolging van cijfers, dat is de 
epoch. Uit de epoch halen we uur, minuut, seconde, dag, maand en jaa. We zetten 
alles in de RTC, rekening houdend met de nodige correcties. De rest van het 
programma leest de RTC en zet alles op het scherm. Het resultaat is een klok op het 
scherm die volledig gelijk loopt met een een DCF77, een radiogestuurde klok. 
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Uitbreidingen: 


Probeer zelf een mooi display aan te sluiten 

Variabele tz (bovenaan in het programma) is de correctie voor de tijdzone 
en de zomertijd. Probeer die laatste te automatiseren: zomertijd gaat van 
de derde zondag van maart tot de derde zondag van oktober. 


Module ntptime 

Het programma hierboven is een illustratie van netwerktoepassingen in 
MicroPython en toont hoe we ntp-kunnen gebruiken voor de constructie van een 
klok. Voor praktische toepassingen gebruiken we klasse ntptime. Die stelt de RTC in 
en regelt zelf de overgangen van zomer- naar wintertijd. We gebruiken die met 


import ntptime 
ntptime.datetime() 


Module ntptime werkt niet op een RP Pi Pico W. 


Volgend programma gebruikt de klasse voor een klok met een OLED-scherm. 
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Opmerking: de library is gebaseerd op UTC-tijd en houdt geen rekening met 
zomer/wintertijd. Variabele tz maakt de correctie. Tweemaal per jaar moeten we het 
programma aanpassen. 


De controller als access-point 

In deze paragraaf werkt de controller als access-point. Die wordt het centrum van 
een lokaal WiFi-netwerk. PC's en smartphones kunnen hierop inloggen, ze krijgen 
hun IP-adres en kunnen een website op de controller raadplegen. Toepassingen van 
de voorbeelden hierboven kunnen we hier ook implementeren. 


Figuur 112: de controller als access-point 


-151- 


We gebruiken volgende methodes: 


e _network.WLAN(network. PA_IF) creëert een WLAN object voor de 
controller als access-point 

e _active(True) en active(False) activeren of de-activeren de 
netwerkinterface 

e _activel{True) maakt de interface actief 

e connect (ssid, password) geeft het draadloos netwerk een ssid en een 
paswoord. De DHCP-server van de controller levert IP-parameters aan 
toestellen die zich aansluiten. 

e _ifconfig() geeft de IP-parameters van de controller. Het IP adres van de 
controller gebruik je om de webpagina op te roepen. 


De rest van het programma is analoog aan de voorbeelden van webservers 
hierboven. 
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Â_ esp8266-AP 
G Verbinding maken 


Beveiligingssleutel voor netwerk invoeren 


A Proximus-Home-3710 


(fa Proximus Public Wi-Fi 


A WiFi-2.4-AA10 


A WiFi-5.0-AA10 


Figuur 113: het access-point is beschikbaar 


Het volgende voorbeeld is de combinatie van een access-point en een webserver. 
Het is gemaakt voor de RP PI Pico W. In de declaratie van led wordt “LED” gebruikt, 
dat verwijst naar de ingebouwde led van de Pico W. Verander deze opdracht als je 
een ander bordje gebruikt. 
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In regel print(ap.ifconfig()) toont het programma zijn IP-gegevens, die kan de client 
gebruiken om de webpagina op te roepen. 


COT 


A Niet beveiligd | 19216841 \ % GIO 
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MicroPython access-point 


Groetjes vanuit ons nieuw access-point 


Figuur 114: MicroPython access-point 
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